<!--
    Document   : custom dictionary
    Author     : Annamaria Jakab
-->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <HEAD>
	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
	<TITLE>Custom Dictionary in Name import</TITLE>
 <link rel=stylesheet type="text/css" href="../marvinmanuals.css">
</HEAD>
  <body>

  <h1>Custom Dictionary in Name import</h1>


<p>It is possible to extend the name to structure conversion by putting
structures with their name in a custom dictionary file. Names present in
the custom dictionary will be converted to the corresponding structure. The
custom dictionary has precedence over the standard name to structure conversion.
</p>
<p>Default path: CHEMAXON_DIR/custom_names.smi where CHEMAXON_DIR is located at:
        <ul>
            <li>Windows: C:\Documents and Settings\USERNAME\chemaxon</li>
            <li>Linux: /home/USERNAME/.chemaxon</li>
            <li>OS X:  /Users/USERNAME/.chemaxon</li>
        </ul>

<h3>Format</h3>
<p>
For performance reasons, the dictionary has to be in smiles format.
To use a dictionary in another format, it can be converted to smiles using
molconvert or mview (Save As). In the same way, several dictionaries should
be merged into a single dictionary file in smiles format.

<p>
Smiles format is supported in 2 different ways:

smiles and name fields, separated by tabs.
eg.
C\C=C\CCC(O)=O gamma-hexenoic acid

if there are named properties in the file, NAME field will be used.
eg.
#SMILES EXACT_MASS NAME<br>
C\C=C\CCC(O)=O 114.1424 gamma-hexenoic acid

<h3>Using a different location for the dictionary</h3>

Path can be changed from API or console by using the „dict” property:

<h4>API</h4>
Molecule mol = MolImporter.importMol("CUSTOMNAME", "name:dict=PATH");

<h4>Command line</h4>
molconvert smiles -s CUSTOMNAME{name:dict=PATH}</p>

  </body>
</html>
